Un constat que je fais depuis un certain temps déjà est que la documentation devient de plus en plus difficile à maintenir, et que le nombre de pages qui vont devenir vétustes par manque de temps ou par manque de nécessité de les mettre à jour (programmes simples à utiliser ou ne n'ayant pas eu de mise à jours / nouvelles fonctions par exemple). De plus on oublie souvent le fait que l'on n'écrit pas uniquement de la documentation pour l'environnement Gnome, mais également xFce, KDE 4.x et UNR/Moblin. Je ne suis pas utilisateur KDE, mais je pense qu'ils doivent se sentir un peu "isolés" dans la documentation, malgré leurs thèmes spécifiques.
En fait c'est simple et compliqué à la fois, il serait marrant/intéressant/idéal que lorsque l'on se trouve sous doc.ubuntu-fr.org on ne retrouve que le mot "ubuntu" lorsqu'il s'agit d'une référence à notre distribution, ce même mot serait remplacé automatiquement par "kubuntu" sur doc.kubuntu-fr.org, et "xubuntu" sur doc.xubuntu-fr.org .
Je ne sais pas si c'est réalisable et cela impliquerait de remplacer ces références "ubuntu" par quelque chose du type distribution qui serait remplacé automatiquement.
Inutile si on se limite aux mots "Ubuntu", Kubuntu" etc. Il faut élargir l'idée a des paragraphes entiers (texte+captures), ce qui me parait une bonne idée à priori, mais compliquera la comprehension/edition de la source des pages pour les nouveaux contributeurs. — YannUbuntu 2009/07/06 09:37
La c'est mon esprit tordu qui imagine ça, mais il serait aussi agréablement intéressant pour les utilisateurs enregistrés qui auraient renseigné la version sur laquelle ils tournent dans leur profil, qu'ils n'aient que les informations relatives à cette version d'afficher sur une page. Cela impliquerait encore un niveau complémentaire de balises dans les pages à savoir inventer un tag <version 9.04>texte relatif à cette version</version>. Ces blocs seraient donc masqués et affichables d'un simple clic sur un lien. On pourrait voir en début de page quelque chose du style
affiche: 8.04 / 8.10 / **9.04** / Tout
La aussi il s'agit d'ajouter une syntaxe de filtrage par blocs. remarques idem filtrage d'environnement. — YannUbuntu 2009/07/06 09:37
Cette fonction serait un bouton supplémentaire qui serait présent sur toutes les pages qui n'ont pas pour tag la dernière version d'ubuntu (Jaunty en ce moment). Le principe serait de pouvoir lire une page, si elle est encore adéquate on valide juste avec ce bouton qui ajouterait le tag complémentaire sans besoin d'éditer la page et de l'enregistrer.
ok, si cette fonction est accessible uniquement par un utilisateur enregistré. — YannUbuntu 2009/07/06 09:37
Un autre point qu'il serait intéressant de rapprocher avec la doc c'est toute la documentation déjà existante et disponible sur notre système.
Les paquets d'abords sont une source d'information idéale (nom du paquet pour le nom de la page de documentation, description, nom du programme, site web officiel éventuellement). Il serait intéressant que les programmes accessibles par l'installateur "ajouter/supprimer…" et qui n'ont pas de page de documentation en ait une générée automatiquement avec ces informations de base, une structure simple de page (installation, configuration, liens).
On pourrait même pousser le raisonnement plus loin en imaginant que toutes les pages, même celles existantes possèdent ce lien étroit avec les paquets, cela permettrait peut être d'accélérer/améliorer la traduction/description de ces éléments. Cette structure complète pourrait être intégrée avec juste une balise du type search?q=%20nom_du_paquet&btnI=lucky
On pourrait imaginer pour la création de nouvelles pages une série de questions pour orienter le rédacteur et créer automatiquement un squelette de page contenant déjà toutes les informations classiques "titre, description, …".
Me parait indispensable pour faciliter le travail des nouveaux contributeurs ! — YannUbuntu 2009/07/06 09:37
Un énorme soucis avec la politique actuelle de tout mettre à la racine, relativement aux ACL, est que l'on ne peut pas empêcher la création de nouveaux namespaces. Je pense qu'il faut limiter la création aux personnes non connectées, ne serait-ce que pour un soucis de contact des primo autores des pages. et bon si les anonymes peuvent pas créer, et bien, on peut toujours taper sur les doigts des inscrits qui ont pas lu les règles
Tout le monde est daccord pour ajouter un lien dans le menu de gauche vers la page expliquant comment participer à la doc.
De même pour le remplacement du lien de l'énorme archive du wiki par un lien vers la page qui parle de la documentation hors ligne, page à modifier en conséquence.
ok. — YannUbuntu 2009/07/06 09:37
J'en profite pour rajouter un lien vers la page de téléchargement d'ubuntu, après tout quand on cherche une info sur gnu/linux on tombe très souvent sur les pages de la documentation d'ubuntu, autant inciter les gens à l'essayer ;)
on devrait avoir le portail "Telecharger Ubuntu" dans la nouvelle page d'accueil de la Doc. — YannUbuntu 2009/07/06 09:37
indispensable. — YannUbuntu 2009/07/06 09:37
je n'en vois pas l'interet non plus. — YannUbuntu 2009/07/06 09:37
on peut s'en passer grace aux backlinks. Mais ca peut etre pratique (si fiable). — YannUbuntu 2009/07/06 09:37
indispensable. — YannUbuntu 2009/07/06 09:37
comme les tags sont tres majoritairement des pages existantes, et que les listes "pages contenant le tag xx" ne sont pas fiables, je me demande si on ne pourrait pas se passer du plugin… — YannUbuntu 2009/07/06 09:37
Il faut ajouter quelques plugins à notre cher dokuwiki pour améliorer l'apparence des pages. C'est une volonté récurrente sur la liste, et cela rentrerai également dans le cadre du nouveau design. En vrac quelques plugins à tester.
pour. — YannUbuntu 2009/07/06 09:37
Si on ajoute un bouton "Participer au wiki" dans le menu de gauche, on devrait pouvoir s'en passer. — YannUbuntu 2009/07/06 09:37
Base pour une refonte éventuelle de la page Thesaurus
Appliquer un tag c'est se demander : "Y a-t-il besoin d'une page regroupant des liens vers toutes les pages concernant ce sujet?"
Question 1: À partir de combien de pages est-il nécessaire d'avoir un tag pour gérer ce groupe de pages?
une petite dizaine? — YannUbuntu 2009/07/06 09:37
Question 2: Que penseriez-vous de mettre les tags sur deux lignes, la première contenant les tags propres au contenu de la page, la deuxième contenant exclusivement les tags des versions concernés, comme par exemple:
Dapper Feisty Gutsy Hardy
matériel réseau wifi
bof. pas esthetique et fait perdre de la place. — YannUbuntu 2009/07/06 09:37
Anciennes versions qui ne sont plus supportées
Les pages et informations concernant ces versions sont amenées à disparaître, ainsi que ces tags.
Versions supportées
Les pages doivent être écrite dans l'optique d'aider l'utilisateur sur toutes ces versions, et en particulier les versions LTS. Mettre les tags pour lequel les informations sur la page conviennent.
Versions en cours de développement Ces tags apparaissent à partir de la sortie de la première bêta (évitez d'écrire des informations sur des versions alpha qui peuvent ne plus être adéquates avec la version finale).
Tout matériel, périphérique externe, carte interne, chipset, ordinateur complet, … dont l'utilisation nécessite la création d'une page doit se voir attribué le mot-clé matériel (notez l'accent) suivi d'un ou plusieurs tags décrivant le type de matériel.
Ces tags permettent de catégoriser les logiciels, une bonne pratique est de voir comment sont taggés les logiciels similaire. Une autre bonne pratiques est de regarder où apparaît le raccourcis dans votre menu Applications, car celui ci est déjà dans une catégorie. En premiers tags on peux préciser à quel environnement de bureau le logiciel est destiné si tel est le cas ou quelle configuration il utilise.
Ensuite vient la catégorisation suivant le type de logiciel, une bonne pratique serait de suivre les catégories déjà définies par freedesktop.org
En premier lieu un tutoriel doit comporter le tag tutoriel.
Toutes les pages sont en quelque sorte des tutoriels, néanmoins on considère une page comme un tutoriel lorsque celle-ci fait appel à des notions et des procédures faisant généralement intervenir plusieurs applications.
Par exemple une page expliquant comment lire une vidéo en présentant les codecs et les divers programmes possibles est un tutoriel, alors qu'une page présentant totem le lecteur vidéo de gnome uniquement n'en est pas un.
En plus du tag tutoriel ces pages comportent les tags correspondant à ce qu'elles expliquent choisis dans les tags matériels et/ou les tags d'applications.
1- Une imprimante multifonction avec lecteur de carte testé sous Dapper Gutsy Hardy:
2- Aptitude:
3- Totem:
4- Tutoriel sur Comment accéder à ses partitions windows:
Le nuage de tags recense beaucoup de tags qui sont des erreurs ou qui ne devraient pas être utilisés